home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / sweep1.arc / CWEEP1.DOC < prev   
Encoding:
Text File  |  1984-10-07  |  8.5 KB  |  280 lines

  1.  
  2.  
  3.  
  4.                             CWEEP version 1.30
  5.                     File maniulation utility for MS-DOS
  6.                                29-June-1984
  7.  
  8.  
  9.                                 CWEEP V1.30
  10.      
  11.                             Copyright (c) 1984
  12.      
  13.                                     by
  14.                                Gary M. Berg
  15.                         5850 Duncraig Dr., Apt. 806
  16.                              Dayton, OH  45426
  17.                               CIS 70106, 1624
  18.      
  19.      
  20.           This software is released to the public domain and may be
  21.      freely reproduced and distributed as long as such is not for
  22.      gain.  The author provides to warranty of fitness or accuracy of
  23.      the software.
  24.      
  25.           CWEEP was inspired by the CP/M utility SWEEP.  CWEEP
  26.      provides the same capabilities to a Z-DOS/MS-DOS system user
  27.      which SWEEP provides to the CP/M user.  This program does not
  28.      attempt to provide all of the capabilities which the NEWSWEEP
  29.      programs do, but provides some additional extensions to provide
  30.      capabilties which I have found useful.
  31.      
  32.           The following is an alphabetic list of the commands provided
  33.      in CWEEP:
  34.      
  35.       sp/cr    Advance to the next file in the list.
  36.         A      Again.  Retag all files which display a "#" in the tag
  37.                field.  Used for copying a set of files to more than
  38.                one disk, or for deleting a set from a disk after they
  39.                have been copied elsewhere.
  40.      
  41.         B      Back up to previous file in list.
  42.      
  43.         C      Copy a single file to another dirve.  Asks for
  44.                destination drive.  Form is d[:[v]]; specifying "v"
  45.                will cause the copy to be verified.  Examples:
  46.      
  47.                b    Copy to drive B:
  48.                b:   Same as above
  49.                b:v  Copy file to drive B:, and verify the copy
  50.                     afterward by re-reading the file and comparing the
  51.                     resulting CRC with the CRC computed when the file
  52.                     was read from the source disk.
  53.      
  54.                In all cases the date/time will be correctly copied to
  55.                the output file.  This will NOT support MS-DOS 2.0
  56.                subdirectory names.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                  Page -1-
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                             CWEEP version 1.30
  73.                     File maniulation utility for MS-DOS
  74.                                29-June-1984
  75.  
  76.  
  77.      
  78.        -C      Copy file to another name.  User must specify a
  79.                complete output file name.  Asks for verify or not.
  80.      
  81.         D      Delete an individual file.  Asks for Y/N to confirm.
  82.      
  83.         E      Erase all tagged or untagged files.  Optional file by
  84.                file confirmation is available.  This option is more
  85.                robust than the corresponding option is SWEEP V3.8;
  86.                the user must specify [T]agged or [U]ntagged.
  87.                Otherwise, the input is ignored.
  88.      
  89.         F      Free space on a drive.  Note that this is a different
  90.                letter than in SWEEP.  Will give correct results for
  91.                both Z-DOS 1.1 and MS-DOS 2.x.
  92.      
  93.         H      Hexidecimal dump of file to screen.
  94.        -H      Hex dump of file to screen; pauses at the end of each
  95.                256 byte segment.
  96.        +H      Hex dump of file to screen and printer.
  97.      
  98.         I      Information.  Prints size in bytes and time for file,
  99.                since there was insufficient space on regular prompt
  100.                line to display this information.
  101.      
  102.         J      Jump to a file in the list.  Works if list is ordered
  103.                by file name or extension.  Examples:
  104.      
  105.                S         Jump to first "S" or extension blank.
  106.                A.BAT     Jumps to "A"'s or ".BAT" extensions.
  107.      
  108.                Jump positions you after the matching files if the list
  109.                is sorted in inverse order.
  110.      
  111.         L      Log in new drive and files.  Can specify a wildcard to
  112.                match or just a drive.
  113.      
  114.         M      Mass copy of tagged files to a specified drive.  Drive
  115.                is specified the same way as for copy command, and may
  116.                include the verify option.
  117.      
  118.        -O      Output a list of tagged files to a specified disk file
  119.                name.  May specify "CON" or "PRN" for name; will query
  120.                if the output file should be deleted if it already
  121.                exists.
  122.      
  123.        +O      Output a list of untagged files the same as "-O".
  124.      
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.                                  Page -2-
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.                             CWEEP version 1.30
  141.                     File maniulation utility for MS-DOS
  142.                                29-June-1984
  143.  
  144.  
  145.         P      Protected mass copy of tagged files.  Same as "M" but
  146.                will ask if a file should be deleted if it exists on
  147.                the output drive.
  148.      
  149.        -Q      Provide a list of tagged files to screen.
  150.        +Q      Provide a list of untagged files to screen.
  151.      
  152.         R      Rename a file.  Enter new name.  If new name is "*",
  153.                will ask for an input wildcard, and a new wildcard for
  154.                renaming those files, as SWEEP does.
  155.      
  156.         S      Sort the directory listing.  Can sort by name,
  157.                ext/name, size, and date.  Lead in with "-" to sort by
  158.                inverse of whatever.  Date is great for copying off
  159.                what you last changed.
  160.      
  161.         T      Tag a file.  Marks with "*" in list.
  162.      
  163.         U      Untag a file.  Removes "*" from list.
  164.      
  165.         V      View a file to screen.  We use Spellbinder for out
  166.                wordprocessor, so the view option throws away all line
  167.                feeds, translate <CR> and <VTAB> to a <CR><LF> when
  168.                displaying on the screen.  Normally, this causes no
  169.                problem with text files.  The display can be paused by
  170.                pressing any key except <ESC> or <CR>; those terminate
  171.                the view command.  The same choice of keys can be used
  172.                to restart the display.
  173.      
  174.        -V      View as above, but pause every 22 <CR>'s.
  175.        +V      View to screen and printer.
  176.      
  177.         W      Tag all files matching a wildcard name.ext.
  178.        -W      Tag all files not matching a wildcard name.ext.
  179.      
  180.         Z      Change an MS-DOS 2.x subdirectory name.  When I saw how
  181.                simple it was to emulate a CHDIR command, I put it in.
  182.                Note that you can only be in one subdirectory at a time
  183.                on any given drive, and that there is no way to copy
  184.                from one subdir to another in this version.
  185.      
  186.      ? or /    Print help list.  Re-prints the informational message
  187.                printed by CWEEP at startup.  If preceeded by a "-" or
  188.                "+", will print a help message for all command which
  189.                are prefxed in that manner.
  190.      
  191.           As an interesting note, control-P and control-N work to
  192.      toggle printer echo on/off, since this program uses the BDOS
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.                                  Page -3-
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.                             CWEEP version 1.30
  209.                     File maniulation utility for MS-DOS
  210.                                29-June-1984
  211.  
  212.  
  213.      calls to do all I/O to the keyboard.  This can be disconcerting
  214.      if you aren't expecting it.  It also means you can get a listing
  215.      of exactly what you did, and get crude directory listings sorted
  216.      by all of the list sort orders.
  217.      
  218.      
  219.           I wrote CWEEP because in our company we were unable to
  220.      consider moving our users from CP/M to Z-DOS without some such
  221.      capability.  It is written in CI C-86, but does not use in of the
  222.      CI I/O subroutines.  The disk I/O routines came from an "unknown"
  223.      user on the Programmer's SIG [72155,1402], and the CRC routine is
  224.      the one used in YAM.
  225.      
  226.           CWEEP will not support I/O re-direction except as provided
  227.      directly by MS-DOS 2.0 for the BDOS calls.  Obviously, it can be
  228.      confusing to try and write redirection files for a program which
  229.      is so terminal interactive.
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                  Page -4-
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277. XA 6: 
  278.  
  279.  
  280. 
  281. 
  282. 
  283.